home *** CD-ROM | disk | FTP | other *** search
/ Amiga Magazin: Amiga-CD 1997 November & December / Amiga-CD 1997 #11-12.iso / pd-disketten / dms-gepackt / 12_95 / apd-12-95-4-2.dms / apd-12-95-4-2.adf / SuperPrint / SuperPrint.doc < prev    next >
Text File  |  1994-06-18  |  16KB  |  426 lines
  1.  
  2.                               SuperPrint
  3.                              ------------
  4.  
  5.  
  6.                        THE LUXUS PRINT-UTILITY
  7.  
  8.                      description to version 3.5b
  9.  
  10.                              17 June 1994
  11.  
  12.                              PD-Giftware
  13.  
  14.  
  15.                      (german and english version)
  16.  
  17.  
  18. ----------------------------------------------------------------------
  19. --                   SuperPrint requires OS-2.04 or higher.         --
  20. --                       It was depeloped under OS-3.0              --
  21. ----------------------------------------------------------------------
  22.  
  23.  
  24.                         SUPERPRINT description
  25.                        ------------------------
  26.  
  27. SuperPrint is a helpful utility for printing ASCII-things like
  28. documents or sourcecodes. Well, this work could also be done with the
  29. DOS-command 'TYPE', but is TYPE able to
  30.  
  31.  
  32.  - number pages?
  33.  
  34.  - define edges?
  35.  
  36.  - handle oversized lines?
  37.  
  38.  - print own information on each page?
  39.  
  40.  - handle headers and footers?
  41.  
  42.  - create a table of contents?
  43.  
  44. Nes!!
  45.  
  46. The edges can be defined via PREFS, well, but there the whole thing
  47. ends!
  48.  
  49.  
  50.  
  51. However, the maincause for my work was, that I wanted to print the
  52. description to 'TERM' and I found some print tool in my PD-collection.
  53.  
  54. But the description for TERM is realy long, so I didn't realize lines
  55. with overlength.
  56. Result: The page-layout (headers and footers) was totally disturbed,
  57. because this tool didn't handle this.
  58. (And so here a call to all programmers and docu-writers: please keep
  59. the linelength in your projects within 70 chars, but never longer than
  60. 79 chars! As you can see, this manual also keeps this form.)
  61.  
  62. So I wrote my own program, Intuition-frontend, OS-2.0 Functions, which
  63. I want to describe now (well, I have to, at the moment I'm the only
  64. one knowing all features).
  65.  
  66. New since version 3.0 is the automatic Table Of Contents. Therefor it
  67. have to be an additional file for each manual containing all headlines
  68. for the Table.
  69.  
  70. After starting the program an information is shown to you for a
  71. short time while SuperPrint gets initialized. Then it is replaced with
  72. the mainwindow.
  73.  
  74.  
  75.  
  76.                             The Mainwindow
  77.                            ----------------
  78.  
  79. Different gadgets appears (buttons, strings, cycles):
  80.  
  81. FILENAME ...... An ASL-Filerequester appears, so you can choose the
  82.                 file you want to print.
  83.                 In the string-gadget right to the button the name of
  84.                 the file can be edited by hand.
  85.                 If a 'TableOfContents'-File (later more) is found it
  86.                 is told you via requester and you can choose to use
  87.                 it. It's senseful, but it takes a little time (realy
  88.                 just a little!) The main- is also an appwindow, so you
  89.                 can put the icon of the file you want to print into
  90.                 the SuperPrintWindow.
  91.  
  92. SCAN FILE ..... This function checks the choosen file for the max.
  93.                 linelength and counts the needed pages. The results
  94.                 will be displayed in the two boxes right to the
  95.                 SCAN-Button. If the SCAN-Function is activated in the
  96.                 Options-Window (later more) a small message gives you
  97.                 detailed information about formfeeds, number of pages,
  98.                 number of lines and some more.
  99.  
  100. LEFT MARGIN ... Here you can enter the number of blanks between the
  101.                 left paperedge and the beginning of the text
  102.  
  103. RIGHT MARGIN .. Here you can enter the charposition where the line
  104.                 ends. You can take the real length of the lines out
  105.                 of the box 'Chars/Line'.
  106.  
  107. LINES/PAGE .... Here you can enter the number of the max. possible
  108.                 lines on a page.
  109.  
  110. <- PREFS ...... With these three buttons right to the inputfields the
  111.                 program automatically uses the default values given by
  112.                 the system-preferences.
  113.  
  114. HEADLINES ..... Here you can enter the number of lines for the header
  115.                 (from the lines/page-number).
  116.                 
  117. BOTTOM ........ here you can enter the number of lines for the footer
  118.                 (in its kind the same like HEADLINES).
  119.  
  120. EXTRA TEXT .... here you can enter a special text appearing on each
  121.                 page in the header or the footer (later more)
  122.  
  123. HEADER ........ The first cycle-gadget is for selecting the style of
  124.                 the header on each page (plain, bold or italic)
  125.                 The second gadget is for selecting the contents of the
  126.                 header: its either 'empty', shows the 'pagenumber' or
  127.                 the 'Extra text'.
  128.                 Therefor the header should be at least one line large.
  129.  
  130. FOOTER ........ These cyclegadgets are similar to the HEADER-Gadgets,
  131.                 but not for the header, they're (I think you guess it)
  132.                 for the footer.
  133.                     
  134. PRINT IT ...... Starts printing. A small control-window appears
  135.                 showing you what's going on. And you can even cancel
  136.                 the thing.
  137.                 If there should also be printed a TableOfContents,
  138.                 the file is scanned twice and so the controlwindow
  139.                 appears twice, but you can't abort the first scan.
  140.  
  141. OPTIONS ....... opens a second window with more settings to do (later
  142.                 more)
  143.  
  144. PROGRAM-INFO .. shows an information around the program
  145.  
  146. EXIT .......... To make it short: the program executes without any
  147.                 comment and without keeping the settings (only if
  148.                 saved before via options-window) the same function
  149.                 as if you use the close-gadget of the window, the
  150.                 program terminates itself. Well, this EXIT-Button is
  151.                 absolutely horrible, but commodore requires that
  152.                 function.
  153.  
  154.  
  155. Values behind the remarks
  156.  
  157. PAGES .............. Number of pages from the selected file (only
  158.                      valid after scanning)
  159.  
  160. MAX. CHARS/LINE .... maximal number of chars per line for the selected
  161.                      file (only valid after scanning)
  162.  
  163. CHARS/LINE ......... the effective length of a line using the edges
  164.  
  165. LINES/PAGE ......... shows you the number of printable lines per page
  166.                      between the header and the footer.
  167.  
  168.  
  169.                           The OPTIONS-Window
  170.                          --------------------
  171.  
  172. Here you can edit not-so-often changed settings. Most of the functions
  173. are handled by CYCLE-Gadgets.
  174.  
  175. MORE CHARS .... If a line is longer than defined via edges, it can be
  176.                 choosen what have to be done with the rest of this
  177.                 line. 'Cut off' means that these chars will be not
  178.                 printed, 'print...' prints this chars, but this could
  179.                 derange the layout! 'Split' will devide the original 
  180.                 line into more lines of the set length.
  181.  
  182. FORMFEED ...... Some files contain 'formfeed'. Well, that's a
  183.                 wunderful thing if the writers kept the form.
  184.                 But if not......YOU have SuperPrint, and with this
  185.                 function you can tell SuperPrint to ignore those
  186.                 formfeeds ('ignore') or to use them ('notice').
  187.                 IGNORE is usefull, if a file contains Formfeeds, but
  188.                 they're not placed very well (caused by this headers
  189.                 and footers).
  190.  
  191. CPI ........... If a file contains realy long lines (more than 80
  192.                 chars) and you need them, you can switch to a higher
  193.                 CPI (the higher the CPI, the more chars can be printed
  194.                 in one line)
  195.  
  196. QUALTITY ...... Here you can choose the art of printing, 'Letter' for
  197.                 LetterQuality, 'Draft' for a faster print.
  198.  
  199. PAGE TEXT ..... Here you can enter where to place the pagenumber,
  200.                 'left', 'center' or 'right'.
  201.  
  202. TEXT (%N-NO) .. Here you can enter an additional text for the
  203.                 pagenumber. '%N' stands for the pagenumber
  204.  
  205. SCAN INFO ..... Here you can turn on or off the extra-information by
  206.                 SCAN. It shows you after a scan further infos about
  207.                 the file (if there are formfeeds,....).
  208.  
  209. PRINT ......... This allows you to print the file on both sides of
  210.                 you paper. Therefor you can first print the odd pages
  211.                 and then the even pages - or print all pages in the
  212.                 normal way.
  213.  
  214. SAVE .......... saves the current settings (also from the main-window)
  215.                 in a file called 'SP.config' in the SuperPrint-Drawer.
  216.                 The next call from Superprint automatically uses this
  217.                 config then.
  218.                 The program returns to the mainwindow
  219.  
  220. USE ........... The program returns to the mainwindow, the settings
  221.                 will be used.
  222.  
  223. CANCEL ........ the programm returns to the mainwindow, the settings
  224.                 before calling the OPTIONS-window will be used.
  225.  
  226.  
  227.  
  228.                                Interna
  229.                               ---------
  230.  
  231. All controlcodes in the choosen text will be used, but not the
  232. formfeed, which is, just like you set it up,  ignored or handled
  233. internally (that means: the topical page will be ended, the footer
  234. will be printed and a new page will be begon.
  235.  
  236. The edges are EVER measured in charth with the width of 10 cpi, the
  237. extra text and the pagenumber are also printed in this width.
  238.  
  239. Since version 3.5 the font of the (Default)PublicScreen is used for
  240. text-output. If the screen is to small for that text-output (gadgets,
  241. etc.), the program uses automaticaly topaz 8 (wherever it fits).
  242.  
  243.  
  244.  
  245.                        Create a TableOfContents
  246.                       --------------------------
  247.  
  248. Since version 3.0 to each manual a TableOfContents can be created.
  249. Therefor it has to be an additional file to the manual with the same
  250. name, but with the extension '.sprint'. This file contains all
  251. headlines and further SuperPrint-settings.
  252.  
  253. The following keywords are realized:
  254.  
  255. LEFT=        - sets the left Edge (like the gadget)
  256. RIGHT=       - same for the right edge
  257. LINES=       - sets the lines per page
  258. HEAD=        - sets the number of lines for the header
  259. FOOT=        - same for the footer
  260. HEADMODE=    - sets the text for the headers (0 - empty,
  261.                                               1 - pagenumber,
  262.                                               2 - extra-text)
  263. FOOTMODE=    - same for the footer
  264. HEADSTYLE=   - sets the kind of the headers  (0 - plain,
  265.                                               1 - bold,
  266.                                               2 - italic)
  267. FOOTSTYLE=   - same for the footers
  268. TEXT=        - sets the extra-text
  269. CPI=         - set the CPI  (0 - 10 CPI,
  270.                              1 - 12 CPI,
  271.                              2 - 17 CPI)
  272.  
  273. PAGEPOS=     - sets the position of the page-text (0 - left,
  274.                                                    1 - center,
  275.                                                    2 - right)
  276. ONE=         - sets the number of lines printed before printing the
  277.                TableOfContents and then a new page will be begon.
  278.  
  279. INDEXHEAD=   - sets the text, wich will be printed on the first page
  280.                of the TableOfContents.
  281.  
  282. STYLE=       - sets the form of the headlines, at this time there are
  283.                BOLD for bold headlines and LEFT to move the headlines
  284.                one character left
  285.  
  286. @x=          - here you can enter the headlines, x stands for further
  287.                definitions to the text: 0 - text is the same as in the
  288.                                             manual
  289.                                         1 - it's the begining of a
  290.                                             headline
  291.                                         2 - like 1, but the text is
  292.                                             copied from the manual
  293. NOSORT=      - Turns the alphabetic sort of the headlines off. The
  294.                sorting is made up by the pagenumbers.
  295.  
  296. As example there is a '.sprint'-file added to this manual.
  297.  
  298.  
  299.                                 APPEAL
  300.                                --------
  301.  
  302. I beg all program- and textauthors to add a '.sprint' to their
  303. productions. It is produced fast and raises the farsightedness of the
  304. printings. And the manuals should not contain lines longer than 70
  305. chars, because the rest of this lines will be cutted off or the
  306. printing will be disturbed.
  307.  
  308. In the name of all users I thank you and as a programmer I'll accept
  309. my rules, too.
  310.  
  311.  
  312.                         Copyright, the Author
  313.                        -----------------------
  314.  
  315. I think, this program is made up very well, it is not free from any
  316. rights indeed, because some routines and procedures in this program
  317. are used in other programs of mine, which are not public domain.
  318.  
  319. But they are my own procedures, so it doesn't matter!
  320. But they are subjected to the (c) copyright from J. Schmitz [SOFT].
  321.  
  322. Since version 2.4 SuperPrint is giftware, it can be freely copied and
  323. used. If you like this program and if you use it frequently, I would
  324. be thankful for a little donation (something about 10,- DM).
  325. Who can't treat oneself, I know that as an ex-student, should send a
  326. small message to me (via snailmail, via Fido, via AmigaNet,...) with
  327. suggestions and/or questions.
  328.  
  329. If you want, you can also send disks, own programs, good graphics,
  330. samples or musicfiles instead of money.
  331.  
  332. Well, I bought myself an A4000 and my pockets are more than just empty
  333. now, and so I'm glad for every donation (money, of cause or tips'n
  334. tricks to the A4000 or something else).
  335. (But you should better send those useful things like potatoesacks or
  336. garden-mould to other people!)
  337.  
  338. The  distribution  on  PD-Disks  (-series)  and on elecronical way for
  339. SuperPrint is allowed and wished.
  340.  
  341. The price for a PD-Disk may not be higher than 6,- DM!! If you put the
  342. program  on  a  PD series disk send a copy of this disk to the author,
  343. that's all you must do.
  344.  
  345.  
  346.                               My Adress:
  347.  
  348.                            Juergen Schmitz
  349.                                  "PD"
  350.                             Bergstrasse 82
  351.                           56859 Bullay/Mosel
  352.                                GERMANY
  353.  
  354.  
  355.                        you can also find me in
  356.  
  357.                  FIDO: Juergen Schmitz, 2:2454/550.3
  358.  
  359.                AMIGA-NET: Juergen Schmitz, 39:176/401.2
  360.  
  361. And before I forget it, but the following text must be, because
  362. otherwise this program won't be free from rights:
  363.  
  364. Written with KICK-Pascal 2.0, MAXON-Computer GmbH.
  365.  
  366. And now -  perfect print...
  367.  
  368.  
  369. ---------------------------------------------------------------------
  370.  SuperPrints History
  371. ---------------------------------------------------------------------
  372.  
  373. Version 3.5b: startup window opening changed
  374.  
  375. Version 3.5:  GUI font sensitiv (thanks to program "Barney" ;-)
  376.  
  377. Version 3.4:  BugFixes, address changed
  378.  
  379. Version 3.3:  Bug in TabelOfContents printing removed
  380.  
  381. Version 3.2:  New line-overlength handling (Split), print only odd
  382.               or even pages - NEW OPTIONS-FILE FORMAT!
  383.  
  384. Version 3.1.5:New command STYLE added
  385.  
  386. Version 3.1:  'TableOfContents' now not cogent alphabetic
  387.  
  388. Version 3.0:  'TableOfContents'-generator included
  389.  
  390. Version 2.4:  Some bugs removed (footer on last page was printed in
  391.               the wrong style) Better texts, SuperPrint is now
  392.               GIFTWARE. SuperPrint now uses the system-default-font if
  393.               possible
  394.  
  395. Version 2.3b: Bug in the in V2.3 changed printfunction removed
  396.               (lines >80 Zeichen were ever cutted),
  397.               Notices by SCAN-function adjusted and added
  398.  
  399. Version 2.3:  SCAN-function implemented, 'lines/page'-field added,
  400.               the english doc removed, because to old and no time for
  401.               a new. AmigaGuide-File added
  402.  
  403. Version 2.2:  new functions, options-window for further settings,
  404.               save-option, the handling of the edges changed
  405.  
  406. Version 2.1:  beta-version to 2.2
  407.  
  408. Version 2.0:  now with WB-AppWindow, so Icons can be dropped in the
  409.               window
  410.  
  411. Version 1.9:  bugs removed, SCAN FILE now with 'Abort'
  412.  
  413. Version 1.8:  new function SCAN FILE, optics changed, better handling
  414.               from ESC-Codes
  415.  
  416. Version 1.7:  no changes, but now available in english
  417.  
  418. Version 1.6:  first public release, only german
  419. ---------------------------------------------------------------------
  420.  
  421. English description done by Matthias Wege, added and updated by
  422. myself.
  423.  
  424.  
  425. JS/06
  426.